home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #2 / Monster Media No. 2 (Monster Media)(1994).ISO / maximus / mfile112.zip / MAXFILE.DOC < prev    next >
Text File  |  1994-06-26  |  31KB  |  862 lines
  1.  
  2. _____________________________________________________________________________
  3. |                                                                           |
  4. |               MaxFile/2, a text based files.bbs manager                   |
  5. _____________________________________________________________________________
  6.  
  7.  
  8.  
  9.  
  10.   Portions of the header files used in compilation are:
  11.  
  12.         Copyright (C) 1992, Scott Dudley
  13.         Copyright (C) 1994, Marco Maccaferri
  14.  
  15.  
  16. From the Development Team of:
  17.  
  18.       Ronald Van Iwaarden     1:104/338        MaxFile/2  Development
  19.       Craig Morrison          1:201/60         MaxFile/PM Development
  20.  
  21.  
  22.  
  23. Special Thanks go out to:
  24.  
  25.   Scott Dudley        For making Maximus the great BBS that it is!
  26.   Marco Maccaferri    For providing the Lora structures and Lora itself
  27.   Rick Ford           Keeping me up to date with the Lora-BBS information
  28.   Walter Bright       MEM.C, a package to track pointer bugs.
  29.  
  30. If I missed anyone, well...you know who you are! Thanks!
  31.  
  32.  
  33.  
  34.  
  35.  
  36. Forward:
  37. --------
  38.  
  39.  
  40.     For about 12 months, I have been getting by using (H)url to
  41. move files from one area to another and then pulling up an external
  42. editor to try and manipulate file descriptions.  Needless to say, this
  43. got very tedious and to try and get around this, I searched for an
  44. OS/2 based file manager.  As many of you know, there was none so I set
  45. out to write my own.  MaxFile/2 is the cumulation of all that effort
  46. to date.
  47.  
  48.     I originally only wanted a manager to edit descriptions, move
  49. files and change archive types (I like all ZIPs).  As time went on and
  50. as people found out about my efforts, creeping featuritis began to
  51. set in and MaxFile/2 is now IMHO, the most powerful file manager
  52. available to Max/2 sysops.  It is multi-threaded, has most every
  53. feature found in many popular DOS based file managers, and it is fully
  54. 32-bit.
  55.  
  56.     MaxFile/2 is also always in need of improvement.  If you have
  57. any suggestions or bug reports, feel free to let me know at any of the
  58. addresses at the end of this document.  The Internet address is
  59. probably the most stable of the addresses given as I hope to complete
  60. my PhD in applied mathematics in the next year (mid 95) or so and
  61. completing my degree will probably take me to another part of the
  62. country given that I find a "real" job.
  63.  
  64.     Support will always be given in the OS2Prodsupport echo, the
  65. OS2BBS echo and the MUFFIN echo which are available at the Fernwood
  66. BBS as well as many other quality OS/2 Fidonet BBS's throughout the
  67. world such as my own.  Support will also be given via mail to any of
  68. the addresses that are given at the end of this document.
  69.  
  70.  
  71.  
  72. How it works:
  73. -------------
  74.  
  75.     MaxFile/2 is a menu based file manager that is similar in
  76. appearance to most file managers that you might have encountered for
  77. normal file management.  There are three main menu options: File which
  78. does many manipulations on files, Sort which will sort the files.bbs
  79. on the name, date or size field, and Description which will allow you
  80. to manipulate the description of any given file in the files.bbs.
  81. These menus are brought down by pressing the key <alt-F>, <alt-S> or
  82. <alt-D> respectively.
  83.  
  84.     The remainder of the top line is used for filling you in on
  85. the status of the threads that may be running in the background.
  86. Immediately following the word Description, file names will appear when
  87. their archive types are being changed.  At the far right of the top
  88. line is where file names are displayed when they are files (GIF, JPG,
  89. BMP, TIF, PCX, TXT) that are being displayed by the external viewer.
  90. This is  done so that you can then edit the description while you are
  91. viewing the file.
  92.  
  93. If you ever have any questions, pressing <F1> will bring up a window
  94. with a description of your present options.  This does not yet work
  95. for all situations but it does work for the areas where you have the
  96. greatest number of choices.
  97.  
  98.  
  99. Installation:
  100. -------------
  101.  
  102.     First, move the file emx.dll to somewhere in your libpath and
  103. then edit the file maxfile.cfg to fit your setup. Now, just run it and
  104. you should be set.
  105.  
  106.  
  107.  
  108. Config file key words:
  109. ----------------------
  110.  
  111.     MaxFile/2 uses a simple text based configuration file to set
  112. up some basic parameters.  The key words and their descriptions will
  113. follow here:
  114.  
  115.  
  116.  
  117.  
  118. KEY  xxxxxxx
  119.  
  120. This is the registration key for your copy of MaxFile/2.  If you do
  121. not have a registration key, the easiest way to get one is to send in
  122. the enclosed registration form!  :-).  If you do not have one, put any
  123. number here and there will be a two second public service message at
  124. the beginning of the program before you can continue.
  125.  
  126.  
  127.  
  128.  
  129. BBS_TYPE xxxxx
  130.  
  131. This is the type of BBS you run.  Right now, only Maximus, Lora, and
  132. SuperBBS  are supported.  If you run a different type of bbs that uses
  133. a standard files.bbs, contact either of the authors about getting
  134. support for your type of bbs.  There is also, now, support for a
  135. "generic" type of BBS.  The only restriction is that the BBS must use
  136. a files.bbs approach to cataloging files.  See the later section
  137. "Generic BBS configuration" for more information on how to set up this
  138. type of BBS.
  139.  
  140.  
  141.  
  142.  
  143. FBP  d:\max\fbp.exe
  144.  
  145. This is the command line for your file index maintinance utility.  For
  146. Maximus sysops, this is either fbp.exe or fb.exe.  If you are a Lora
  147. sysop, this program is called fileidx.exe.  Lora sysops also need to
  148. include the index file that is to be updated.  For example, if you
  149. want to update the allfiles.idx index file, you would have the line
  150. "FBP g:\lora\fileidx.exe fileidx.idx" instead of the above line.
  151.  
  152.  
  153.  
  154.  
  155. AutoFB YES|NO
  156.  
  157. This determines whether or not FB (or FBP) as defined above will
  158. automatically be run on the changed file areas when MaxFile/2 exits.
  159.  
  160.  
  161.  
  162.  
  163. MAXDIR   d:\max
  164.  
  165. This is simply where you keep MAXP.EXE and all the related utilities.
  166. It is necessary.
  167.  
  168.  
  169.  
  170.  
  171. TEMPDIR d:\temp
  172.  
  173. This is a directory were all work can be done.  This is only used if
  174. you have not defined the TMP environment variable in which case the
  175. directory stored in TMP will be used.  If you have defined neither the
  176. TMP directory or the above TEMPDIR, MaxFile/2 will create
  177. sub-directories off of the present directory to do it's work.
  178.  
  179.  
  180.  
  181.  
  182. sysinfo d:\max\area.dat
  183.  
  184. This is the location of your file area system information.  For
  185. Maximus sysops, this is your area.dat file and for Lora sysops it is
  186. the sysfile.dat file.  Simply give the full path for this file.
  187.  
  188.  
  189.  
  190.  
  191. DATE   (YES|NO)
  192.  
  193. This config verb simply sets the default status for displaying the
  194. date.  That is, it the verb is set to NO, then the date will not be
  195. displayed in a window for each file as  default (it can be toggled
  196. back on easily enough if wanted).
  197.  
  198.  
  199.  
  200.  
  201. SIZE   (YES|NO)
  202.  
  203. This config verb simply sets the default status for displaying the
  204. file size.  That is, it the verb is set to NO, then the file size will
  205. not be displayed in a window for each file as  default (it can be
  206. toggled back on easily enough if wanted).
  207.  
  208.  
  209.  
  210. WRAP   (YES|NO)
  211.  
  212. This config verb simply sets the default status for displaying the
  213. file description.  That is, it the verb is set to NO, then the file
  214. description  will not be wrapped as the default.  (it can be toggled
  215. back on easily enough if wanted).
  216.  
  217.  
  218.  
  219.  
  220. Window1Area 0
  221. Window2Area 1
  222.  
  223. These are the areas in which the two window will open up in.  The
  224. default is area 0 and 1 (This does not necessarily the same as in your
  225. filearea.ctl) as defined by the area change window.
  226.  
  227.  
  228.  
  229.  
  230. GIF joeview
  231. JPG joeview
  232. BMP joeview
  233. TIF joeview
  234. PCX joeview
  235. TXT e
  236.  
  237. These are the commands for viewing GIF, JPG, BMP, TIF, PCX, or TXT files
  238. respectively. They do not have to be the same and the default is for
  239. them to not be installed and they do not have to be the same command.
  240. It is assumed that it will take a file name on the command line.  For
  241. example, if I type "joeview os2.bmp", Joeview will come up with
  242. os2.bmp as the image.
  243.  
  244.  
  245.  
  246.  
  247. LowPriRearchive (YES|NO)
  248.  
  249. This sets the priority level at which the file re-archiving is done.
  250. If it is set to YES, the priority level of the re-archiving is set to
  251. Idle, delta 1.  If it is set to NO, then the re-archiving is done at
  252. the level at which MaxFile/2 is running.  The default is YES
  253.  
  254.  
  255.  
  256.  
  257. DefDescription xxxxxxxxxxxxxxx
  258.  
  259. This is the description given to files that are adopted and do not
  260. have a file_id.diz or desc.sdi in the archive.  It can be up to 60
  261. characters long and can have any ascii symbols you want.
  262.  
  263.  
  264.  
  265.  
  266. VirusCheck os2scan.exe /nopause /report c:\cprog\maxfile\virscan.log
  267.  
  268. An External virus scanner can be used.  The expected format for this
  269. command is that the scanner is run, taking a directory on the
  270. command line and all files in that directory will be scanned.  The
  271. return code is expected to be 0 if no virii are found and non-zero
  272. otherwise.  The example here is for Ann Mcafee's oscan.exe.  The
  273. scanner is run in a separate session so you can watch it's progress.
  274.  
  275.  
  276.  
  277.  
  278. zip_extract   unzip -x -o -U
  279. zip_add       zip -9 -r
  280. zip_list      unzip -v
  281. zip_test      unzip -t
  282.  
  283. These describe the command line for dealing with .zip files.  It is
  284. assumed that the archive is taken as argument 1 (after the above
  285. string) and, for extraction, the files to be extracted are taken as
  286. further arguments.  The example given should work for most Max/2 sysops
  287.  
  288.  
  289.  
  290. arj_extract   unarj e
  291. arj_add
  292. arj_list      unarj l
  293. arj_test      unarj t
  294.  
  295. These describe the command line for dealing with .arj files.  It is
  296. assumed that the archive is taken as argument 1 (after the above
  297. string) and, for extraction, the files to be extracted are taken as
  298. further arguments.  The example given should work for most Max/2 sysops
  299.  
  300.  
  301.  
  302.  
  303. lh_extract         lh x
  304. lh_add             lh a
  305. lh_list            lh l
  306. lh_test            lh t
  307.  
  308. These describe the command line for dealing with .lzh files.  It is
  309. assumed that the archive is taken as argument 1 (after the above
  310. string) and, for extraction, the files to be extracted are taken as
  311. further arguments.  The example given should work for most Max/2 sysops
  312.  
  313.  
  314.  
  315.  
  316. arc_extract   arc x
  317. arc_add       arc a
  318. arc_list      arc l
  319. arc_test      arc v
  320.  
  321. These describe the command line for dealing with .arc files.  It is
  322. assumed that the archive is taken as argument 1 (after the above
  323. string) and, for extraction, the files to be extracted are taken as
  324. further arguments.  The example given should work for most Max/2 sysops
  325.  
  326.  
  327.  
  328.  
  329. WrapComents (YES|NO)
  330.  
  331. Since many times, you just want to see that the comments are there so
  332. that you can see the spacing, this keyword will prevent the
  333. descriptions of the comments from being wrapped, no matter what is
  334. done with the rest of the window.
  335.  
  336.  
  337.  
  338.  
  339. Touch_Adoptee (YES|NO)
  340.  
  341. This determines whether or not a file is to be "touched" (file date
  342. brought up to the current date) when you adopt it.  The default is YES
  343.  
  344.  
  345.  
  346.  
  347. AutoAdopt (YES|NO)
  348.  
  349. This determines whether or not to automatically adopt the orphan files
  350. in a file area when you enter a new file area.
  351.  
  352.  
  353.  
  354.  
  355. adopt            zip
  356.  
  357. This keyword simply describes what sort of file extensions to look for
  358. when adopting orphaned files.  You can have up to 15 of these lines.
  359.  
  360.  
  361.  
  362.  
  363. ColourName      BLUE
  364. ColourReadOnly  CYAN
  365. ColourSize      MAGENTA
  366. ColourDate      GREEN
  367. ColourDesc      RED
  368. ColourHighlight YELLOW
  369.  
  370. This is where you can set up the colours for MaxFile/2.  They are
  371. fairly self explanatory.  The possible colours are Black (not
  372. recommended), RED, BLUE, MAGENTA, WHITE, GREEN, CYAN, BROWN, and
  373. YELLOW.
  374.  
  375.  
  376.  
  377.  
  378. DupIgnoreExtension (YES|NO)
  379.  
  380. If this keyword is set to yes, then MaxFile/2 will ignore the
  381. extensions of file names when searching for duplicates.
  382.  
  383.  
  384.  
  385.  
  386. American_date (YES|NO)
  387.  
  388. If this keyword is set to yes, then dates will be displayed in the
  389. form mm/dd/yy.  If it is set to no, then dates will be displayed in
  390. dd/mm/yy format.
  391.  
  392.  
  393.  
  394.  
  395. ExtendedDesc  ?
  396.  
  397. If your BBS supports using extended descriptions in the files.bbs,
  398. enable this keyword and replace the '?' with the special character
  399. that is used by your BBS system to identify extended descriptions. If
  400. you are a Maximus user, leave this line commented out.  For example if
  401. your files.bbs can look like the following:
  402.  
  403. myfile.zip This is a file for which I have decided to use an extra
  404. >          long description.  The special character for my BBS type is
  405. >          the '>' which indicates that the comment for the previous
  406. >          file is continued on this line.
  407.  
  408. You would replace the '?' above with a '>' to enable these long
  409. descriptions.  The extended description is edited with an external
  410. editor which is defined later with the externaledit verb. The
  411. 'e' editor works very nice for this purpose.  Also, the above special
  412. character cannot be a space, a '-', a letter, or a number.
  413.  
  414.  
  415. VerticalWindows (YES|NO)
  416.  
  417. This config verb will allow MaxFile/2 open up window windows split
  418. either vertically or horizontally.  If this variable is set to YES,
  419. then MaxFile/2 opens up with two windows side by side.  If it is set
  420. to NO, then you get one window on top and one on the bottom.
  421.  
  422.  
  423. Macro? <string>
  424.  
  425. This config verb (where ? is any number from 2 to 9) describes a macro
  426. that can be run on the selected files.  The macro can be any sort of
  427. external program, specifically, a .cmd file can be very useful.  The
  428. macro is run with the command line parameters:
  429.  
  430.  
  431. c:\file\filename.ext c: file\ filename ext
  432.       (1)            (2) (3)     (4)   (5)
  433.  
  434. (1) is the fully qualified file name
  435. (2) is the drive for the file
  436. (3) is the path with a trailing slash (or back slash)
  437. (4) is the file name (without extension)
  438. (5) is the file extension.
  439.  
  440. This could be especially useful for extracting a file to a specific
  441. directory, extracting a "read.me" file or something along that line.
  442. This is done in a separate thread (such as the picture viewer) so one
  443. can edit descriptions and perform other operations while the macro is
  444. performing it's work  The macros can be accessed by pushing function
  445. key i (that is, press <F2> for macro2 and <F6> for macro6,...).
  446.  
  447.  
  448.  
  449. externaledit <string>
  450.  
  451. This config verb allows you to define an external editor to edit the
  452. descriptions rather than using the built in editor.  If you are using
  453. extended descriptions, then this must be defined.  If you have not
  454. defined an extended description character, then all control-returns
  455. that are in the edited file will be changed to spaces.  If you want to
  456. use the built in editor, then either comment out this line or leave
  457. the string blank.
  458.  
  459.  
  460. strip_high_asci (YES|NO)
  461.  
  462. This config verb allows you to configure whether or not you want the
  463. high ascii characters stripped from the file_id.diz when it is used as
  464. the description.  Naturually, set it to YES if you want the high ascii
  465. stripped and set it to no if you want the high ascii retained.  If it
  466. is set to YES, then all high ascii characters are changed to spaces
  467. and sequences of more than three spaces are collapsed to a single space.
  468.  
  469.  
  470. Generic BBS configuration:
  471. --------------------------
  472.  
  473. If your BBS type is not presently have built in support with MaxFile/2
  474. or MaxFile/PM, you can add a "generic" setup.  Simply change the
  475. BBS_TYPE to generic and then create a configuration file that
  476. describes your file areas as follows:
  477.  
  478. ───────────────────────────── AREAS.CFG sample ────────────────────────────────
  479. AreaCount 5
  480. 0 d:\max\file\uncheck    d:\max\file\uncheck\files.bbs    Unchecked Uploads
  481. 1 d:\max\file\max        d:\max\file\max\files.bbs        BBS Stuff
  482. 2 d:\max\file\dos\games  d:\max\file\dos\games\files.bbs  Dos Games
  483. 3 d:\max\file\os2\util   d:\max\file\os2\util\files.bbs   OS/2 Utilities
  484. 4 d:\max\file\os2\apps   d:\max\file\os2\apps\files.bbs   OS/2 Applications
  485. ───────────────────────────────────────────────────────────────────────────────
  486.  
  487. The 'AreaCount' keyword tells MaxFile/2 how many area definitions it
  488. can expect to find in the file. The AreaCount keyword must come BEFORE
  489. the area definition lines.
  490.  
  491.   The format for each area definition line is:
  492.  
  493.     <area tag> <file path> <list name> <area description>
  494.  
  495.     <area tag>          - Is a short name to identify the file area.
  496.     <file path>         - Is the path to the files.
  497.     <list name>         - Is the full drive\path and filename of the
  498.                           FILES.BBS for the area. 
  499.     <area description>  - Is a description of the area.
  500.  
  501. All four items MUST be on each line.
  502.  
  503. You can name this file what ever you wish, just make sure you specify
  504. the name of this file for the sysinfo variable in the maxfile.cfg
  505. file.
  506.  
  507. Please be aware that if we can install normal support for your BBS
  508. type, then MaxFile/2 will interact more smoothly with your BBS and
  509. there will be one less configuration file to setup.  If you have
  510. information regarding the structure for storing file area information
  511. and also have the permission of the BBS author to distribute this
  512. information, please forward it to either the author of MaxFile/2 or
  513. MaxFile/PM at one of the addresses at the end of this document.  It is
  514. usually quite easy to add support for new BBS types and we can
  515. probably have a new executable for you within a couple of days.
  516.  
  517.  
  518.  
  519.  
  520. Command Line Options:
  521. ---------------------
  522.  
  523. MaxFile/2 now supports several command line options that can be used
  524. for nightly/weekly maintinance.
  525.  
  526. -allfiles:    This command line option will force MaxFile/2 to
  527.         to create a file called maxfile.all in the present
  528.         directory.  It will be a complete list of all files
  529.         in your files.bbs with the size and dates listed with
  530.                 the filename.  MaxFIle/2 will look for the files
  531.                 allfiles.hdr and allfiles.ftr in the current directory
  532.         which will become the header and footer of the
  533.         allfiles list.
  534.  
  535.                 For customization, MaxFIle/2 will read in the files
  536.                 allfiles.hdr as the header of your allfiles list and
  537.                 allfiles.ftr as the footer for the allfiles list.
  538.                 These files must be in the present directory to work.
  539.                 If they cannot be found, then no header or footer will
  540.                 be created.
  541.  
  542.                 Finally, MaxFile/2 will look for the file maxfile.exc
  543.                 in the current directory.  This file will contain the
  544.                 numbers of the areas that will be excluded from the 
  545.                 all files list, listed one per line.  A sample
  546.                 maxfile.exc is included.  This can be used so that
  547.                 certain (hidden, passworded) file areas will not be
  548.                 listed in the allfiles list.
  549.  
  550.  
  551.  
  552. -adopt:        This option will cause MaxFile/2 to adopt all of the
  553.         orphans in all file directories that are pointed to
  554.         by a file area.  When files are adopted, MaxFile/2
  555.         will attempt to extract a file_id.diz or desc.sdi and
  556.         use that as the file description.
  557.  
  558.  
  559. -file_id:    This option will go into every file area and check
  560.         every file that is listed in the flies.bbs to see if
  561.         it has a file_id.diz or desc.sdi to be used asa file
  562.         description.
  563.  
  564.  
  565. -sort:        This option will open the files.bbs in every area,
  566.         sort the files.bbs according to name.
  567.  
  568.  
  569. The -adopt and -file_id.diz options will print a description of what
  570. they are doing on stdout which can be used as a log.  That is, you
  571. could run MaxFile/2 every night with the command line:
  572.  
  573. maxfile -adopt >> adopt.log
  574.  
  575. which will give a list of what files were adopted in which areas and
  576. the descrtiption that was used for the file.
  577.  
  578. Be aware that the -file_id option can take a VERY long time.
  579. Essentially, it needs to try to unzip file_id.diz from every file in
  580. your file list which, as you can imagine, takes quite a while.  Also,
  581. until MaxFile/2 is registered, you will need to press return to run it
  582. after a 5 second pause.
  583.  
  584. Also, these command line options can be combined and will be run in
  585. the order that they are given.  For instance, if you wanted to adopt
  586. all files, sort the file areas and then write an all files list, you
  587. could give the command
  588.  
  589. maxfile -adopt -sort -allfiles
  590.  
  591. which would perform the three tasks in order.
  592.  
  593.  
  594.  
  595. File Menu Options:
  596. ------------------
  597.     
  598. Here is where the majority of my work is done with MaxFile/2.  This
  599. will do most of your normal file manipulations for the files.bbs.
  600. Most of the options are fairly self-explanatory but I will go through
  601. them anyway.  Whenever I say it will operate all selected files, I mean
  602. that, if you have selected files, it will operate on those selected
  603. files and if you have not selected any, then it will operate on the
  604. presently highlighted file.
  605.  
  606.  
  607. Move:          This will move all selected files to another file area.
  608.                You will be provided with a window that gives you the
  609.                option to remove or accept the presently selected files. It
  610.                will bring up a window to select the area and then, upon
  611.                selection, will move the files. You can press <esc> to
  612.                cancel.
  613.  
  614.  
  615. Contents:      This will un archive the file and then it will display
  616.                the contents of the archive in a window.  You can scroll
  617.                through the display of this window and take a look at all
  618.                the files in the archive.
  619.  
  620.  
  621. Verify:        This will attempt to verify the selected files archive
  622.                using the command given in the MaxFile.cfg
  623.  
  624.  
  625. Re-archive:    This will attempt to change the archive type of the
  626.                selected files. It will even allow you to re-archive to
  627.                the same type (such as changing zip 2.04 to zip 1.10).
  628.                This is done in the background and, as each file is being
  629.                re-archived, the name is displayed at the top of the main
  630.                window on the same line as the word Description.
  631.  
  632.  
  633. Delete:        This will delete the selected files and remove the
  634.                description from the files.bbs.  You will be presented
  635.                with a list of the selected files and will have the
  636.                option of removing files from the list or accept it as
  637.                is.
  638.  
  639.  
  640. vieW:          If you have defined a viewer in the maxfile.cfg, then this
  641.                option will view all the selected files.  As each file
  642.                is is displayed with the external viewer, the file name
  643.                is displayed in the upper right hand corner of the window.
  644.  
  645.  
  646. Touch:         This will attempt to go to go to each file and set the
  647.                last modification date of the file to the present date.
  648.                This will make it show up on a new-files scan by Maximus
  649.  
  650.  
  651. scaN for virii:If you have defined an external virus scanner, this will
  652.                un archive the file to a temporary directory and then it
  653.            scan that directory for any virii.  It will not recurse
  654.                into archives within an archive.
  655.  
  656.  
  657. marK all:      This will mark (select) all files
  658.  
  659.  
  660. Unmark all:    This will unmark (deselect) all files.
  661.  
  662.  
  663. Save:          This will attempt to save the current state of the files.bbs
  664.                It will backup only on the first save (so you can restore 
  665.                the files.bbs to it's original state.
  666.  
  667.  
  668. Insert:        This allows you to put in a file that cannot be adopted
  669.                (not configured for it) or simply to add comments.  To add
  670.                a new comment, simply insert a file with the name "COMMENTS"
  671.  
  672.  
  673. repOsition:    This is how you can move files around within a files.bbs.
  674.                Simply mark the files you want to reposition, and then move
  675.                the highlight to where  you want it to be moved.  Once there
  676.                select <alt-F> O and then it will reposition all the files
  677.                you have selected to before the highlighted file.  You
  678.                cannot reposition files in front of a selected file.
  679.  
  680.  
  681. dupe searcH:   This will search for files in other areas that have the same
  682.                name as a file in the present file area.  The DUPESKIP
  683.                config variable determines what a duplicate looks like. Once
  684.                a dupe has been found, you may delete one of the files, edit
  685.                the description of one or the other, abort the dupe search,
  686.                examine the contents of either of the files, or skip the
  687.                present dupe pair.
  688.  
  689.  
  690. Locate:        This option works similarly to Maximus's Locate.  If this
  691.                option is chosen, then you will be prompted for a string.
  692.                MaxFile/2 will then search through all the file.bbs's to 
  693.                to try and find this string as either a file name or as a
  694.                substring of a file's description.  It will then open that
  695.                file area and present the located file at the top of the
  696.                present window.  At this point you are allowed several
  697.                options which can be seen by pressing <F1>
  698.  
  699.  
  700. rEname:        This option will allow you to rename a specific file.  Note
  701.                that MaxFile/2 will allow you to rename a file archive to
  702.                have a name (rename foo.zip to foo.arc) that seems to
  703.                indicate an incorrect archive type
  704.  
  705.  
  706. Exit:          Exit MaxFile/2.  If files are being re-archived, you will
  707.                need to wait for this to complete.  You will be prompted
  708.                to save any changes to the files.bbs.
  709.  
  710.  
  711.  
  712.  
  713. Sort Menu Options:
  714. ------------------
  715.  
  716. This will sort the files.bbs based on Name (increasing/decreasing),
  717. date (increasing/decreasing), or on size (increasing/decreasing).  It
  718. will attempt to leave the comments where they.  If you have selected a
  719. range of files, only that range of files will be sorted.  If, on the
  720. other hand, you have not selected any files, the entire list will be
  721. sorted.
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728. Description Menu Options:
  729. -------------------------
  730.  
  731. This is the other most used area.  It allows you to modify the
  732. description or the comments in the files.bbs.
  733.  
  734.  
  735. Remove:        This will remove the description and the files name.  It
  736.                is useful for "hiding" files from the user but leaving
  737.                them in the directory for later insertion.
  738.  
  739. Edit:          This will bring up a window with the file description
  740.                wrapped for each selected file.  The maximum length is 250
  741.                characters (almost the max that Max/2 allows).  You can
  742.                insert new characters, delete or paste into the window.
  743.                Pressing return accepts the new description and pressing
  744.                <esc> will abort the changes
  745.  
  746. New:           This will bring up a window with an empty file description
  747.                for each selected file.  The maximum length is 250
  748.                characters (almost the max that Max/2 allows).  You can 
  749.                insert new characters, delete or paste into the window.
  750.                Pressing return accepts the new description and pressing
  751.                <esc> will abort the changes
  752.  
  753. Use FILE_ID:   This will attempt to extract the file file_id.diz,
  754.                FILE_ID.DIZ, desc.sdi, or DESC.SDI from the file archive.
  755.                If found, it will use this as the file description with
  756.                all high ascii chars changed to blank space.  If you are
  757.                using Info-ZIP for your unzip-per, the case sensitivity may
  758.                cause it to ignore an enclosed file description if it does
  759.                not fit one of the above formats.  The reason is that
  760.                Info-ZIP came from the UNIX world where case sensitivity
  761.                is much more important.
  762.  
  763. Insert Comment:This will insert a comment line before the current line.
  764.                You can then edit the description field so that the comment
  765.                appears as you wish.
  766.  
  767.  
  768.  
  769.  
  770. dupe searcH and Locate options:
  771. --------------------
  772.  
  773. For the following options, only the 'a' and, of course, <F1> work when
  774. it is presently scanning for files.  Once a duplicate pair has been
  775. found, all of the other options are available.
  776.  
  777. a:          Abort the present search.
  778.  
  779. d:          Delete the presently selected file
  780.  
  781. c:          Show the contents of the present file.  This is useful for
  782.             identifying true duplicates.
  783.  
  784. TAB:        Switches between windows.
  785.  
  786. e:          Edit the present file's selection.
  787.  
  788. u:          Uses the file description at the top of the unselected
  789.             window for the present selected file.
  790.  
  791. r:          Remove the description.  This is useful if the file is not
  792.             deleteable or the file does not exist.
  793.  
  794. <esc>:      ignores the presently displayed duplicate pair.
  795.  
  796.  
  797.  
  798.  
  799. Main Menu options:
  800. ------------------
  801.  
  802. Many of the keystrokes at the main menu will allow you to perform many
  803. of the above menu options with a single keystroke.  These can be seen
  804. by pressing <F1> which brings up the on-line help.
  805.  
  806.  
  807. "A":         Change area
  808. "]":         Go to next area
  809. "[":         go to previous area
  810. "R":         Re-scan files.bbs from the disk.
  811. "W":         Toggle the wrapping of file descriptions
  812. "D":         Toggle the display of file dates
  813. "Z":         Toggle the display of file size
  814. "TAB":       Switch between file windows
  815. Up, Down:    scroll file list up, Down
  816. Right, Left: grow window rt, left
  817. HOME, END:   go to top, end of list
  818. pgup,pgdown: file list up, down 1 page
  819. "space":     Select or de-select file
  820. ctrl Right:  shrink right side of window
  821. ctrl Left:   shrink left side of window
  822. ctrl PGUP:   Maximize window
  823. ctrl PGUP:   Restore window
  824. <alt-X>:     Exit MaxFIle/2
  825. <alt-E>:     Edit file description(s)
  826. <alt-R>:     remove (delete) file(s)
  827. <alt-N>:     Scan file(s) for virii
  828. <alt-P>:     View picture files
  829. <alt-A>:     Adopt orphans
  830. <alt-C>:     Contents of archive(s)
  831. <alt-V>:     Verify archive(s)
  832. <alt-I>:     use file_Id.diz
  833. <alt-O>:     Reposition file(s)
  834. <alt-UP>:    Grow top of window
  835. <alt-DOWN>:  Grow bottom of window
  836. <ctrl-UP>:   Shrink top of window
  837. <ctrl-DOWN>: Shrink bottom of window
  838. <F2>-<F9>:   Execute the given macro.
  839.  
  840.  
  841.  
  842. So ends the documentation.  If you have any questions that are not
  843. answered by this or the on-line help (press <f1>).  If you have any
  844. further questions or want to make suggestions for improvements to
  845. MaxFIle/2, feel free to contact me at any of the following addresses:
  846.  
  847. Fidonet:  Ronald Van Iwaarden 1:104/338@fidonet.org
  848. Internet: rvaniwaa@carbon.denver.colorado.edu
  849. OS2NET:   Ronald Van Iwaarden 81:313/1@os2net.ftn
  850.  
  851. The internet address is probably most stable but feel free to give all
  852. of them a try.
  853.  
  854. If you have any comments as to MaxFile/2 or the above documentation,
  855. feel free to let me know and I will see what I can do to fix the
  856. problem.  Thanks for using MaxFile/2.
  857.  
  858.  
  859. If you have any questions regarding the PM version of MaxFile, contact
  860. myself or Craig Morrison at the following:
  861.  
  862. Fidonet:  Craig Morrison, 1:201/60@fidonet.org